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as the reference address of common during the assem- 
bly process. All relocatable addresses of data in com- 
mon are relative to 99999. For example, the 15th lo- 
cation downward in common is assigned the value 
99985, and appears as the same relative address in all 
subprograms. Labels referencing common are assigned 
downward relocation indicators for absolute adjust- 
ment by the Linkage Loader. 

Absolute adjustment involves changing the relative 
values of the labels (assigned to them by the proc- 
essor) to absolute values in the relocated common data 
area. The adjustment factor applied is the difference 
between the value of common in the assembly process 
( 99999 ) and the absolute value of common determined 
by the Linkage Loader. Normally, the Linkage Loader 
will place common at the location represented by the 
value of the system symbol /ams/ (Absolute Memory 
Size). However, the programmer can specify a dif- 
ferent absolute location for common by means of a 
base2 statement. (The interested reader will find a 
fuller discussion of this subject in the publication, 
System Monitor.) 

The steps necessary to use common in a subprogram 
are discussed under "dav — Define Area in common," 
in the subsection "Declarative Operation Codes." 



Processing Options 

There are four processing options which can be exer- 
cised by the user: 

1. He can suppress the printing of the assembly list- 
ing ( on the Standard Print Unit ) . 

2. He can suppress the punching of the object deck 
(on the Standard Punch Unit). 

3. If there are no macro statements in the source 
deck, he can speed up the assembly process by indicat- 
ing this fact. 

4. He can suppress the diagnostic generation of an 
"M" flag for uses of index registers 14 and 15 when 
there is no true multiple definition. ( See note 1, under 
"Indexing with Address Adjustment.") 

These options are indicated by means of additional 
parameters in the exeq card that calls the Autocoder 
processor. 

The four parameters are: 
noprt — Suppress printing 
nopch — Suppress punching 
nomac — No macros present 
noflg — Suppress "M" flag 
Any or all of these parameters may be used in the 
exeq card. They can appear in any order immediately 
following the exeq parameters required by the System 
Monitor. (See the publication, System Monitor, for 
details concerning the exeq card. ) 



Specification of parameters in the exeq card is con- 
cluded by the first blank encountered in the operand 
field. The following examples illustrate the format: 



OPERATION 



LABEL CODE 

MON$$ EXEQ 

MON$$ EXEQ 

MON$$ EXEQ 



OPERAND 

AUTOCODER, SOF, SIU, NOPRT 

AUTOCODER, , , NOMAC, NOPCH, 

NOFLG 

AUTOCODER, , , NOFLG, NOPRT, 

NOMAC, NOPCH 



Autocoder Multiple Compilation 

Autocoder can compile any number of programs with a 
single mon$$ exeq autocoder card. The output is the 
same as if it were produced by several separate com- 
pilations. 

Input for a multiple compilation consists of the 
mon$$ exeq autocoder card followed by the source 
decks to be compiled. No control cards are necessary 
between the end statement of one program and the first 
card of the next program if the programmer wants the 
subsequent compilation to receive standard treatment; 
that is, printing, punching, and normal macro and flag 
processing. 

A different set of processing options ( noprt, nopch, 
nomac or noflg ) can be specified for an ensuing pro- 
gram in a multiple compilation by placing an Option 
card after the preceding end statement. This card has 
the same requirements and options as the mon$$ exeq 
autocoder card except that the label and operation 
fields, card columns 6-20, must contain blanks ( instead 
of mon$$ exeq ) . The processing options specified in this 
Option card will be applied until the next Autocoder 
end card is read by the processor. 

Autocoder multiple compilation has two potential 
advantages: 

1. It enables the programmer to process a series of 
source decks from the Alternate Input Unit as well as 
the Standard Input Unit. 

2. It bypasses the monitor processing which normally 
is necessary between compilations. 



Terminating the Object Program 

The object progam must terminate execution by means 
of one of the following instructions: 

b /eop/ Normal End of Program 
b /uep/ Unusual End of Program 

Both forms of termination are shown in Figure 2. Full 
details can be found in the publication, System Monitor. 
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SAMPLE SUBPROGRAM USING THE 1410/7010 AUTOCODER 
OPCOD OPERAND 



PAGE 1 
CT AOORS INSTRUCTION 



SAM PL 
CARD FLAG 



1 AA020 

2 AA030 

3 S A040 



AA050 
AA060 
AA070 
AA080 
AA090 
AA100 
AA110 
AA120 
AA130 
AA135 
AA140 

15 G AAI40 

16 G 01510 

17 G 01520 

18 G 01530 

19 G 01580 

20 AA145 



* 

5 

6 

7 

8 

9 

10 

11 

12 

13 

1* 



TITLE SEQUENCE 

• THIS SUBPROGRAM CHECKS THE SEQUENCE OF THE PGLN/ FIELD 

• IF THE PGLN/ FIELD IS 99999, THE PROGRAM IS TERMINATED NORMALLY 

• A NON-ASCENDING SEQUENCE RESULTS IN AN UNUSUAL END OF PROGRAM. 
SEQROUTINE SBR EXITSEQRT&5 

C PGLN/, 399999a IS THIS THE LAST ENTRY 

BE ENDOFJOB YES 

NOPHM 

B CHECKSEQ 

SH «-12 



ENDOFJOB 
ENDOFJOB 



21 
22 

23 
24 
25 



AA148 
AA150 
AA160 
AA170 
AA175 



SET FIRST TIME NOP SNITCH TO BRANCH 



MLCWB PGLN/,PGLNH0LD*5 



IOCTL TYPE, MESSAGE 

EQU • 

8ZN •-11,/CTB/ 

BXPA /CNC/ 

OCW MESSAGE 

BZN •-11,/CTB/ 

B /EOP/ 



EXIT - RETURN TO MAIN PROGRAM 



NOTIFY OPERATOR OF END OF JOB 



NORMAL ENO OF PROGRAM 



C PGLNHOLD, PGLN/ 

BH EXITSEQRT-12 BRANCH IF PGLN/ IS IN SEQUENCE 

B /UEP/ UNUSUAL END OF PROGRAM 



7 00000 G 00056 B 002 

11 00007 C PGLN/ 00153 002 
7 00018 J 00058 S 002 
1 00025 N 002 
7 00026 J 00101 002 

6 00033 , 00026 002 

12 00039 D PGLN/ 00158 P 003 

7 00051 J 00000 003 



00058 

12 00058 V 00058 /CTB/ 2 003 

7 00070 Y /CNC/ X 003 

5 00081 00126 003 

12 00082 V 00082 /CTB/ 2 004 

7 00094 J /EOP/ 004 

11 00101 C PGLN/ 00158 004 

7 00112 J 00039 U 004 

7 00119 J /UEP/ 004 



64015 

SEQNO PGLIN LABEL 

26 AA1S0 SEQR/ 

27 AA185 MESSAGE 
2B AA190 

29 AA200 

30 

31 PGLNHOLD 



SAMPLE SUBPROGRAM USING THE 1410/7010 AUTOCODER 
OPCOD OPERAND 

DEFIN SEQROUTINE SEQR/ LINKAGE SYMBOL FOR SUBPROGRAM 

DCU aENO OF J0B3.G CONSOL PRINTER NOTICE 

HALT 12345 EXAMPLE OF AN ERRONEOUS STATEMENT 

END 

399999a 

»0005 

NUMBER OF FLAGGED STATEMENTS 1 
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SAMPL 




IEL 


CT 


AOORS 


INSTRUCTION 
00000 


CARD 
005 


FLAG 




11 


00126 




006 




A 


12 


00137 




007 







5 


00153 




008 






5 


00158 




008 





1410/7010 AUTOCODER... SYSTEM /MID/ 0001 



•Figure 2. A Page from an Assembly Listing 



Assembly Listing 

Each page of the assembly listing contains a page 
heading line and a column heading line. 

The page heading line contains the following infor- 
mation, from left to right: 

1. The date contained at location /dat/ (the system 
symbol for the five-position date field in the Resident 
Monitor) 

2. Information supplied via headr card 



3. Page number in the listing 

4. The identification supplied by headr or reseq 
cards 

The column heading line is illustrated in Figure 2, 
which shows the assembly listing of a subprogram 
assembled by the 1410/7010 Autocoder processor. 
The subprogram contains a deliberate error contrived 
to exhibit Autocoder's diagnostic flagging system. Fig- 
ure 2 illustrates the following items, going from left 
to right in the column heading line: 
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12 3 4 5 
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7 B 9 1011 12131415161718192021 
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Figure 78. ibm 1410/7010 Library Coding Form 



Library Entry 
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7 8 9 101112131415161718192021 
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Figure 80. Model Statement for a Complete Instruction 



Macro-instruction 



Line Label Operation 
B as isie JOS! 



» »o 55 4S_ 



OPEI 



oi. OMda , i . . ZMecXJ>Atl r P.A*9 J 1>AJf.X. 1 TAIl.4, s PAe£: 



_J I I I I t_ 



Assembled Symbolic Program Entry 

ABCD C PAR1,PAR2 

BH PAR3 

BE PAR4 

BL PAR5 

Figure 79. Macro Operations 



that a corresponding parameter from the macro- 
instruction operand field must be inserted in its 
place. This code is a n followed by a number 
from 001 to 199, that indicates the position of 
the parameter in the macro-instruction. The 
macro-instruction in the source program will 
give the parameter entries to be inserted in the 
object routine. The model statement is illus- 
trated in Figure 81. 
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Figure 81. Model Statement for an Incomplete Instruction with 
Required Parameters 

c. If the entry is incomplete, the programmer writes 
a □ followed by a number from 001 to 199 with 
ab bits over the units position (parameter 001 
is nOOA, parameter 2 is nOOB, etc.). This indi- 
cates that the entry is to be included in the 
object routine only if the parameter is specified 
by the macro-instruction. For example, if pa- 
rameter 003 does not appear in the macro- 
instruction, the instruction shown in Figure 82 
will be deleted from the object routine. 
Note: If parentheses are used, the programmer can- 
not use zoned switches in a math or bool statement. 
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Figure 82. Model Statement for an Incomplete Instruction with 
Conditional Parameters 

Labeling: If the model statement represents an in- 
struction entry point for a branch instruction elsewhere 
in the program, it should have a label. 

If additional external labels are required and speci- 
fied as parameters in the macro-instruction they can 
be inserted in the label field of the symbolic program 
entry by using the nOOl-199 code. 

The label of the macro-instruction causes the genera- 
tion of an equate statement in the assembled object 
routine. The label is equated to an *, as shown in 
Figure 83. 

Macro Instruction (Source Program) 



Line 



Label 



Operation 



E££Z2_ 



il. 



ZW£&. 



-I5_ 



ST.A.kX.1. 



Model Statement 



Another example is shown in Figure 84. 

Symbolic Addressing within the Library Routine: 
To allow a symbolic reference to other instructions in a 
library routine a nfollowed by a number from 001 to 
199 with a B bit over the units position (nOOJ = sym- 
bolic address 1, nOOK = symbolic address 2, etc. ) can 
be used. For example, the processor generates the sym- 
bolic address if the code nOOJ is used as a label for one 
entry and as an operand of at least one other entry in 
the same library routine. 

Internal labels within flexible routines are generated 
in the form nnnnmmm, where nnn is the code (00J- 
09R), and mmm is the number of the macro within 
the source program. This is done to avoid duplicate 
address assignments for labels. 

Example: Use the generated symbolic address of 
□00J as an operand for entry 3 and as the label for 
entry 6. updat is the 23d macro encountered in the 
source program ( Figure 85). 

Address Adjustment and Indexing: The parameters 
in a macro-instruction and the operands in partially 
complete instructions in a library routine can have 
address adjustment and indexing. 

If address adjustment is used in both the parameter 
and the instruction, the assembled instruction will be 
adjusted to the algebraic sum of the two. For example, 
if the address adjustment on one is +7 and the other 
is —4, the assembled instruction will have address 
adjustment equal to +3. 

Model statement operands can be indexed. This in- 
dexing takes precedence over any indexing of a param- 
eter supplied by a macro-instruction. The model state- 
ment index is used. 

Literals: Operands of instructions in library routines 
may use literals as required. However, these literals 
may not contain the @ symbol within an alphameric 
literal. 

Note: Area defining literals and area defining con- 
stants cannot be used in a macro statement. 
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Model Statement 
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Assembled Symbolic Program Entry 



Assembled Symbolic Program Entry 



TEST2 

Figure 83. Labeling 
42 
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START1 



TEST2 EQU 

START2 SBR ENTRYA 

Figure 84. Additional External Labels 



Mgcro Instruction (Source Program) 
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Model Statement 
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Assembled Symbolic Program Entry 



B D00J023 

Q00J023 ZA COST,AMOUNT 

Figure 85. Internal Labels 

Note 1: A model statement in the library routine for 
a macro-instruction may not be another macro-instruc- 
tion. 

Note 2: end statements cannot be used in library 
routines. 

Note 3: A comments card can be included in the 
model statements. It must be written with an asterisk 
in column 7. 

The Processor enters model statements in the library 
tape immediately following the header statement dur- 
ing System Generation. 

Result: Any library routine can be extracted by writ- 
ing the associated macro-instruction in the source 
program. 

Figure 86 is a summary of the codes that can be 
used in the model statements of library routines. 



CODE 


POSITION 


FUNCTION 


a 001 - a 199 


Statement 


Substitute parameter 
(parameter must be present) 


nOOA- n!9t 


Statement 


Substitute parameter {if 
parameter is missing, 
delete statement) 


nOOJ - nl9R 


Label Field and 
Operand Field 


Assign internal label 



Figure 86. Model Statement Codes 

General Description: A macro-instruction is the entry 
in the source program that causes a series of instruc- 
tions to be inserted in a program. 

The Programmer: 

1. Writes the name of the library routine in the 
operation field. 
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2. Writes the label that is to reference the first as- 
sembled model statement. A label equ * is generated 
to do this. 

3. Writes the parameters that are required for the 
particular object routine desired. These parameters, 
used by the model statements, are written as follows: 

a. Parameters must be written in the sequence in 
which they are to be used by the codes in the 
model statements. For example, if cost is 
parameter 001, it must be written first so that it 
will be substituted wherever a nOOl or nOOA 
appears as a label, operation code, or operand 
of a model statement. 

b. As many parameters may be used as can be 
contained in the operand fields of five or fewer 
coding sheet lines. If more than one line is 
needed for a macro-instruction, the label and 
operation fields of the additional lines must be 
left blank. Parameters must be separated by a 
comma. They cannot contain blanks or commas 
unless they appear between @ symbols. The 
@ symbol itself cannot appear between @ sym- 
bols. Also, the @ symbol can be used only in 
pairs as a literal identifier. It cannot be used 
in any other way; e.g., a single @ symbol could 
not be used to represent the d modifier of a 
macro-instruction. If parameters for a single 
macro-instruction require more than one coding 
sheet line, the last parameter in each line must 
be followed immediately by a comma. The 
last parameter in a macro-instruction should 
not be followed by a comma. 

c. Parameters that are not required for the par- 
ticular object routine desired can be omitted 
from the operand field of the macro-instruction. 
However, if a parameter is omitted, the comma 
that would have followed the parameter must 
be included, unless the omitted parameter is 
behind the last parameter which is included in 
the macro-instruction. These commas are nec- 
essary to count parameters up to the last in- 
cluded parameter. All parameters between the 
last included parameter and parameter 199 are 
assumed by the processor to be absent. 

Figures 87, 88, 89 and 90 show how parameters can 
be omitted. The hypothetical macro-instruction called 
exact is used, exact can have as many as nine 
parameters. 

The Processor extracts the library routine and selects 
the model statements required for the object routine 
as specified by the parameters in the macro-instruc- 
tions, and by substitution and switches set by bool or 
comp in the model statements. 
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Figure 87. Parameter for exact. 006-199 Missing 
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Figure 88. Parameters 004 and 006-199 Missing 
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Figure 89. Parameters 001, 004-006, 008 and 010-199 Missing 
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Figure 90. Parameters 001 and 003-199 Missing 

Result: The resulting program entries are merged 
with the source program entries behind the macro- 
instruction. 

Pseudo-Macro Instructions 

These statements never appear in a user's source pro- 
gram or in the output listing of an assembled Auto- 
coder program. However, they are used in library 
routines to signal the processor that certain conditions 
exist which can affect the assembly of an object routine. 
For example, the presence of a pseudo-macro- 
instruction in a library routine can cause a group of 
model statements to be deleted. Thus, pseudo-macros 
provide the writer of library routines with a coding 
flexibility which exceeds the limitations of the substitu- 
tion and condition codes described previously. 

Pseudo-macro-instructions may be written anywhere 
in a library routine. The five pseudo-macros incorpo- 
rated in the Autocoder processor are math, bool, 
comp, note, and mend. 

Permanent and Temporary Switches 

The math, bool, and comp pseudo-macros use internal 
indicators (switches) to signal the processor of exist- 
ing status conditions. 

There are 099 permanent and 199 temporary 
switches available for recording status conditions. Each 
switch occupies one core-storage position during the 



macro generator phase of Autocoder. If a storage posi- 
tion contains the character A ( ab 1 bits ) , the switch is 
on; if it contains a ? (cab 82 bits), the switch is off. 
At the beginning of assembly all switches are off. 

Permanent Switches: Permanent switches retain 
status conditions during the entire macro generator 
phase unless changed by a pseudo-macro. They are 
addressed by using a # symbol followed by the three- 
digit number of the switch to be set or tested. For 
example, #001 addresses permanent switch 001; #002 
addresses switch 002; and #099 addresses switch 099. 

Temporary Switches: When the processor encounters 
a macro-instruction, the temporary switches are set to 
the condition ( presence or absence ) of the parameters 
in the operand of the macro field. If the parameter is 
present, the corresponding switch is set on. If the 
parameter is missing, the switch is set off. For ex- 
ample, if parameter 001 is present, temporary switch 
001 is turned on. If parameter 002 is missing from the 
macro-instruction, temporary switch 002 is off. Tem- 
porary switches retain status throughout the processing 
of a macro-instruction unless changed by a pseudo- 
macro. After the macro-instruction has been completely 
processed, all temporary switches are set off. Tempo- 
rary switches are addressed by using a □ symbol fol- 
lowed by the three-digit number of {he switch to be set 
or tested. For example, nOOl addresses temporary 
switch 001; n002 addresses switch 002; and nl99 ad- 
dresses switch 199. 

If a macro with a maximum of nine parameters is 
encountered, the processor sets the first nine temporary 
switches to indicate the presence or absence of these 
nine parameters. Temporary switches 010-199, which 
are off, can be used by the pseudo-macros to com- 
municate conditions to the processor while it is working 
on this particular macro-instruction. This use of tempo- 
rary switches is recommended because it reserves the 
permanent switches for communicating information 
from one macro to another. 



MATH — For Solving Algebraic Expressions 

A math pseudo-macro contains as operands: sum 
boxes, arithmetic expressions, and sign switches. 

Sum Boxes: A sum box is a group of five core- 
storage positions used to store the result of an arith- 
metic expression. Autocoder makes available 20 such 
sum boxes. A sum box is addressed by using a # 
symbol followed by the three-digit number (ending 
in zero or five) of the sum box to be referenced. For 
example, the address of the first sum box is #005; the 
address of the second sum box is #010; and the address 
of the twentieth sum box is #000. 

At the beginning of the macro phase, a sum box 
contains 00000. Any number may be placed in a sum 
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is off, the statement is false. Therefore, set temporary 
I switch 015 off and skip to statement labeled L. 
The example shown in Figure 97 states: 

1. If both temporary switches 001 and 002 or both 
temporary switches 003 and 004 are on, the state- 
ment is true. Therefore, set temporary switch 015 

ON. 

2. However, if either temporary switch 001 or 002 
and either temporary switch 003 or 004 is off, 
the statement is false. Therefore, set temporary 
switch 015 off and skip to the model statement 
whose label is L, 
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Figure 97. bool Pseudo-Macro 



Figure 99. False Conditions 



Figure 98 is a table showing all conditions that will 
cause the bool statement shown in Figure 97 to be 
true. 

Figure 99 is a table showing all conditions that will 
cause the bool statement shown in Figure 97 to be 
false. 



COMP — To Compare Two Fields 

General Description: The comp pseudo-macro com- 
pares an A-field to a B-field (maximum of 15 charac- 
ters), and sets permanent or temporary switches to 
indicate the result of the comparison. 

The Programmer: 

1. Writes the name of the pseudo-macro (comp) 
in the operation field. 
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2. Writes the operand field in the format shown in 
Figure 100. The first and second entries are the A- and 
B-fields. The A- and B-fields may be any of the 
parameters 001-199, sum boxes #005-#000, or literals. 
They cannot be switches. 

Note 1: For the comp pseudo-macro, alphameric 
literals are not enclosed by @ symbols. Entries 3, 4, 
and 5 are high, equal, and low switches. 

Note 2: The codes for the two fields to be compared 
must be present in all comp pseudo-macro-instructions. 
Codes for the switches may be omitted if they are not 
needed to store the result of the compare operation. 
However, if a -switch is omitted, the comma that 
would have followed it must be included in the 
operand field. 

Note 3: B-field controls compare. (High-order posi- 
tion of B-field ends compare. ) 
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Figure 98. True Conditions 



Figure 100. Format for comp Pseudo-Macro 



The Processor: 

1. Compares the A-field to the B-field. 

2. Sets one status switch on and two switches off 
to reflect the result of the comparison. 

a. The first switch is set on, if the value of the 
B-field is greater than that of the A-field. 
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b. The second switch is set on, if the B-field is 
equal to the A-field. 

c. The third switch is set on, if the value of the 
B-field is less than that of the A-field. 

Examples: Figure 101 shows a comp pseudo-macro 
which states: 

1. Compare parameter 002 of the macro statement 

tO WORKAREA. 

2. If parameter 002 is equal to workarea, turn on 
temporary switch 25. 

3. If workarea is less than parameter 002, turn on 
temporary switch 26. 
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Figure 101. comp Pseudo-Macro 



The message is printed in line on the output device 
(tape or on-line printer). In addition, an "N" will be 
automatically inserted in the flag field of the assembly 
listing. 

The Programmer: 

1. Writes the name of the pseudo-macro (note) in 
the operation field. 

2. Writes the message in the operand field. 

Note: Two successive blanks terminate the operand 
of a note statement. 

The Processor: Prints the message on the Standard 
Print Unit (tape or on-line printer). 

Examples: Figure 104 shows how the note pseudo- 
macro can be used in combination with the bool 
pseudo-macro. The bool pseudo-macro tests to ensure 
that parameters 001 and 002 are present in the macro- 
instruction. If either parameter is missing, the proc- 
essor skips to the note pseudo-macro and prints: 



Figure 102 shows a comp pseudo-macro which 
states: 

1. Compare the contents of sum box 005 to param- 
eter 003 of the macro statement. 

2. If the result is high, set temporary switch 024 on. 

3. If the result is equal, set temporary switch 025 

ON. 

4. If the result is low, set temporary switch 026 on. 



parameter absent from macro. 
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Figure 102. Comparing a Parameter to the Contents of a 
Sum Box 



Note: Standard 1410/7010 collating sequence deter- 
mines high, equal, or low conditions. Comparisons 
are controlled by the B-field. Thus, the statement 
shown in Figure 103 will cause temporary switch 025 
to be set on if the low-order position of parameter 
002 is a 3. 

NOTE — To Produce a Message 

General Description: The note pseudo-macro is 
used to write messages concerning conditions that can 
arise during the processing of a macro-instruction. 
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Figure 104. note Pseudo-Macro 

MEND - End of Routine 

General Description: This pseudo-macro signals the 
end of generation for a macro-instruction. It may ap- 
pear anywhere in a library routine. 

The Programmer: 

1. Writes the name of the pseudo-macro (mend) in 
the operation field. 

2. Leaves the operand field blank. 

The Processor: Stops processing the macro-instruc- 
tion when it encounters a mend statement. Figure 105 
shows a mend pseudo-macro. 

Note: A bool pseudo-macro can be used to skip 
over a mend pseudo-macro which appears within the 
library routine if conditions indicate that more model 
statements must be processed. 
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Figure 103. Checking for a Single Character 
48 



Figure 105. mend Pseudo-Macro 



